home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / opalvisn / jopalif.lha / ReadMeNow! < prev   
Text File  |  1993-01-01  |  3KB  |  65 lines
  1.  
  2.  
  3.                        JFORTH LANGUAGE INTERFACE
  4.                                 FOR THE
  5.                       OPALVISION SUPPORT LIBRARIES
  6.  
  7.                      Version 1.0 - 31 December 1992
  8.  
  9.                            By Marlin Schwanke
  10.  
  11.    This archive provides all the required code for the JForth Profesional
  12. programmer to access the support libraries for the OpalVision 24 bit
  13. video/graphics card.  You should find the following listed files included in
  14. the archive:
  15.  
  16.    OpalLib.j           - Header file for the Opal.Library
  17.    OpalReqLib.j        - Header file for the OpalReq.Library
  18.    Opal_Lib.fd         - Function descriptor file for the Opal.Library
  19.    OpalReq_Lib.fd      - Function descriptor file for the OpalReq.Library
  20.    Opal.f              - Library calls and support words for the Opal.Library
  21.    OpalReq.f           - Library calls and support words for the
  22.                          OpalReq.Library
  23.    JForthDemo.f        - Source code for the demo
  24.    IFF24               - A very mindless demo of the interface
  25.    ReadMeNow!          - The file you are now reading
  26.  
  27.    To install this file on your system you need to copy the two '.j' files to
  28. a new directory JI:Opal, copy the two '.fd' files to your FD:  directory, and
  29. then move the '.f' files to wherever you would like, perhaps JU:
  30.  
  31.   To use the code you just need to include the '.f' files.  They will
  32. automatically include the other files as required.  Remember to load the
  33. libraries prior to using them with 'Opal?' or 'OpalReq?'!  Also remember that
  34. all addresses returned by the library functions will be coverted to JForth
  35. relative addresses and all addresses you supply to the library calls should
  36. be JForth Relative as well.  A final note, as with all other AmigaDos
  37. strings, the filenames you provide to the library calls must be '0Strings' (0
  38. terminated C style strings).  For example you might use '0" Filename"' to
  39. introduce a filename into your code.
  40.  
  41.   The demo is an extremely simple example of JForth<->OpalVision code.  It
  42. will load and display a named file.  I was very lazy and didn't include a
  43. WorkBench interface for it.  You must therefore use it from the CLI.  It is
  44. marginally useful, as it can be included in your AmigaDos scripts, and it
  45. doesn't require the user to click the left mouse button for the script to
  46. continue, as does the 'Show24' that comes with OpalVision.  The syntax is
  47. 'IFF24 Filename' to display a picture and just 'IFF24' to turn it back off.
  48. Note that JForth is not required for the demo command to function.
  49.  
  50.   Please refer to the OpalVision Developer's Kit for additional documentation
  51. on using these libraries.
  52.  
  53.   This code is released to the public domain.  No rights are reserved.  No
  54. warantee is made as to it's fitness for any application.  The author assumes
  55. no liability for any damages arising from it's use.  Void where prohibited by
  56. law.
  57.  
  58.   Please contact me if you have comments or suggestions.  I may be reached
  59. via e-mail at a number of locations:
  60.  
  61.   InterNet - marlins@crash.cts.com
  62.   GEnie    - M.Schwanke
  63.   FIDO     - Marlin Schwanke@1:202/1111
  64.            - Marlin@1:202/1112
  65.